home *** CD-ROM | disk | FTP | other *** search
/ GFX Sensations 1 / Graphic Sensations - Volume 1.iso / tools / pc / utility / dos / art2wp.com / ART2WP.DOC < prev    next >
Encoding:
Text File  |  1990-04-24  |  11.3 KB  |  328 lines
  1.  
  2. ART2WP V1.7 First Publisher ClipArt to  Word Processor Image File Translator
  3.                     Copyright 1989-90 by William J. Hinkle
  4.  
  5.                             === User's Guide === 
  6.  
  7. The ART2WP program was created to allow clip art files created through the 
  8. PFS:First Publisher desktop publishing program to be used by word processing 
  9. programs that handle graphics, and in other graphics programs.  To do this, 
  10. ART2WP translates these ART files into any of several other graphics file 
  11. formats.  You can translate to:
  12.  
  13. * .WPG files (Word Perfect 5 graphics format)
  14. * .TIF files (Aldus/Microsoft TIFF format)
  15. * .BIT or .RLE files (Lotus Manuscript graphics format)
  16. * .IMG files (GEM Paint format)
  17. * .GIF files (CompuServe Graphics Interchange Format)
  18. * .PCX files (PC Paintbrush PCX Format)
  19.  
  20. The translator is a single file: ART2WP.EXE.  The default translation is to 
  21. Word Perfect 5 (.WPG) format
  22.  
  23. ==============
  24. COPYRIGHT INFO
  25. ==============
  26. This utility program ART2WP.EXE was written by
  27.  
  28.     William J. Hinkle
  29.  
  30. who retains the copyright.  Copy and use the program freely.  Distribute
  31. it to whomever you want.  But:
  32.  
  33. === Do NOT distribute modified versions.
  34. === Do NOT remove the copyright notice.
  35. === ALWAYS distribute with the documentation.
  36. === DO NOT charge a fee, except for disk copying/library charges.
  37.  
  38. If you feel that this program has been of some utility, please seriously 
  39. consider sending a contribution of up to $5.00 to help defray my
  40. costs run up in developing this utility.  Please indicate if you desire a 
  41. written receipt.
  42.  
  43. William J. Hinkle
  44. 420 E.Boston Mills Rd.
  45. Hudson, OH 44236-1111
  46.  
  47.  
  48.  
  49. ===============
  50. BASIC OPERATION
  51. ===============
  52.  
  53. First create a PFS:First Publisher clip art file, which should have a .ART 
  54. extension on the filename.  These can be clipped from the .MAC art library 
  55. files, or perhaps obtained from local BBSs and other sources.
  56.  
  57. To create a .WPG file (the default), type in:
  58.  
  59. ART2WP fname1
  60. or
  61. ART2WP fname1.ART
  62. or
  63. ART2WP fname1.ART fname2.WPG
  64.  
  65. from the DOS command prompt.
  66.  
  67. * For "fname1", substitute the name of your clip art file, of course!
  68.  
  69. * The .ART and .WPG extensions are assumed if something else is not specified.
  70.  
  71. * The .WPG file name is made the same as the .ART file name if not otherwise 
  72. specified.  Specify a different "fname2" if desired.
  73.  
  74. * Full DOS pathnames can be specified.  If you enter a directory (ending in \) 
  75. or a drive (ending in :) for the second ("fname2") filename, the output file 
  76. will be placed on that path with the default filename; i.e, the input filename 
  77. with a .WPG extension.
  78.  
  79. The .ART file will be translated to a .WPG file.
  80.  
  81. The .ART file will not be erased.  You can also specify scaling factors, but
  82. the defaults work the best (see below).
  83.  
  84. ==================
  85. WILDCARD FILENAMES
  86. ==================
  87. ART2WP doesn't handle wildcard filenames, like *.ART.  But you can accomplish
  88. the same thing by using the DOS "FOR" command.  See your DOS manual's section
  89. on Batch Commands for further info.  To convert all of the ARTs in the current
  90. directory to WPG, for example, type this at the DOS command line:
  91.  
  92. FOR %f in (*.ART) do ART2WP %f
  93.  
  94. If you are converting to something other than WPG, use the /fN "format" command
  95. to set the output format, rather than an output file extension.  If you put
  96. this kind of command in a batch file, be sure to use %%f instead of just %f.
  97.  
  98.  
  99.  
  100. ==================
  101. OTHER FILE FORMATS
  102. ==================
  103.  
  104. To create a new graphics file in one of the other supported formats, you must 
  105. specify the other format.  You have two ways to do this.  One way is to 
  106. specify the output filename ("fname2") with the appropriate extension.  The 
  107. other is to specify the special /f option switch that selects the desired
  108. format.  The second method is usually the best, because the .ART file's 
  109. filename is then automatically used for the output file.
  110.  
  111. Some examples:
  112.  
  113. ---
  114. * To get a Aldus/Microsoft TIFF file:
  115.  
  116. ART2WP fname1 /ft
  117. or
  118. ART2WP fname1.ART fname2.TIF
  119.  
  120. gives you a TIFF file.
  121.  
  122. ---
  123. * To get a Lotus Manuscript graphics file:
  124.  
  125. ART2WP fname1 /fb
  126. or
  127. ART2WP fname1.ART fname2.BIT
  128.  
  129. or, for RLE files, which are often smaller:
  130.  
  131. ART2WP fname1 /fr
  132. or
  133. ART2WP fname1.ART fname2.RLE
  134.  
  135. ---
  136. * To get a GEM Paint graphics file:
  137.  
  138. ART2WP fname1 /fi
  139. or
  140. ART2WP fname1.ART fname2.IMG
  141.  
  142. ---
  143. * To get a CompuServe GIF file:
  144.  
  145. ART2WP fname1 /fg
  146. or
  147. ART2WP fname1.ART fname2.GIF
  148.  
  149. ---
  150.  
  151. * To get a ZSoft PC Paintbrush PCX file
  152.  
  153. ART2WP fname1 /fp
  154. or
  155. ART2WP fname1.ART fname2.PCX
  156.  
  157.  
  158.  
  159. ==============
  160. COMPLEAT USAGE
  161. ==============
  162.  
  163. If you invoke ART2WP from DOS without any other parameters, it will display 
  164. the following help message.  This illustrates some of the other options you 
  165. can select with command line switches.
  166.  
  167. -----
  168. PFS:FP ART-to-WP Image Translator: V1.7 ... Copyright 1989-90 by W.J.Hinkle
  169.  
  170.  
  171. Press a key to get a little help...
  172.  
  173. (...you press a key here, naturally!)
  174.  
  175. Usage: ART2WP fname1 [fname2] [option] [option] ...
  176. where: fname1.ART ... PFS: First Publisher ART input file
  177.        fname2.WPG ... Word Perfect 5 WPG output file (default: fname1.WPG)
  178.    or  fname2.TIF ... Aldus/Microsoft TIFF format output file
  179.    or  fname2.BIT ... Lotus Manuscript BIT format output file
  180.    or  fname2.RLE ... Lotus Manuscript RLE format output file
  181.    or  fname2.IMG ... GEM IMG format output file
  182.    or  fname2.GIF ... CompuServe GIF format output file
  183.    or  fname2.PCX ... PC Paintbrush PCX format output file
  184.        /xN        ... option: x density = N pixels-per-inch (default: 100)
  185.        /yN        ... option: y density = N lines-per-inch (default: per x)
  186.        /v         ... option: reverse video
  187.        /ft        ... option: force TIFF output file
  188.        /fb        ... option: force BIT (Lotus Manuscript) output file
  189.        /fr        ... option: force RLE (Lotus Manuscript) output file
  190.        /fi        ... option: force IMG (GEM) output file
  191.        /fg        ... option: force GIF (CompuServe) output file
  192.        /fp        ... option: force PCX (PC Paintbrush) output file
  193.  
  194. Press a key to continue...
  195.  
  196. ART2WP is a translator from First Publisher ART image files
  197. to various word processor image file formats:
  198.  
  199. To Word Perfect 5 WPG files (this is the default)
  200. or Microsoft/Aldus TIFF files (fname2.TIF, or use /ft option),
  201. or Lotus Manuscript BIT/RLE files (fname2.BIT/RLE, or use /fb, /fr options),
  202. or GEM IMG files (fname2.IMG, or use /fi option),
  203. or CompuServe GIF files (fname2.GIF, or use /fg option),
  204. or ZSoft PC Paintbrush files (fname2.PCX, or use /fp option).
  205.  
  206. PFS: First Publisher is a trademark of the Software Publishing Corporation.
  207. Word Perfect is a trademark of the Word Perfect Corporation.
  208. Manuscript is a trademark of the Lotus Development Corporation.
  209. GEM is a trademark of the Digital Research Corporation.
  210. GIF and 'Graphics Interchange Format' are trademarks of CompuServe Inc.
  211. PC Paintbrush is a trademark of ZSoft Corporation.
  212.  
  213. Shareware by: William J. Hinkle CIS [71121,3211]
  214.  
  215. (followed by some shareware info...)
  216.  
  217. -----
  218.  
  219.  
  220.  
  221. =============
  222. REVERSE VIDEO
  223. =============
  224.  
  225. Normally ART2WP keeps black and white the same between the ARTfile and the
  226. output file.  If you want a reverse video effect, use the /v option switch.
  227.  
  228. ==================
  229. SIZING AND DENSITY
  230. ==================
  231.  
  232. Normally ART2WP make a output file with an image density of 72x72 pixels (or 
  233. lines) per inch, the same as First Publisher uses.  This lets your program
  234. compute the "natural" size of the graphics image.  You can specify a different
  235. density by specifying it with either the /x or /y option switches (e.g. /x200
  236. is 200 pixels and lines per inch).  You can also alter the aspect ratio (to
  237. "stretch" the image one way or the other) by specifying both the /x and the
  238. /y option switches, with different density values.
  239.  
  240. Of course, you can usually scale the image in your other application program.
  241.  
  242.  
  243.  
  244. ======
  245. HELP?!
  246. ======
  247.  
  248. Should you have any difficulties using this program, please 
  249. contact me via Compuserve EasyPlex (or on the CompuServe PICS forum):
  250.  
  251. William J. Hinkle [71121,3211]
  252.  
  253. ======
  254. THANKS
  255. ======
  256.  
  257. Thanks to:
  258.  
  259. Tom Pfau, for his public domain LZW compression/decompression code
  260. Bruce Philp, for his help in testing this program
  261.  
  262. ==========
  263. LEGALITIES
  264. ==========
  265. PFS: First Publisher is a trademark of the Software Publishing Corporation.
  266.  
  267. Word Perfect is a trademark of the Word Perfect Corporation.
  268.  
  269. Manuscript and Lotus Manuscript are trademarks of the
  270. Lotus Development Corporation.
  271.  
  272. GEM is a trademark of the Digital Research Corporation.
  273.  
  274. GIF and 'Graphics Interchange Format' are trademarks of CompuServe Inc., an
  275. H & R Block Company.
  276.  
  277. PC Paintbrush is a trademark of ZSoft Corporation.
  278.  
  279. *************************************************************************
  280. *   Revision History:                                                   *
  281. *   -----------------                                                   *
  282. *   Version number  Date        Explanation                             *
  283. *   --------------  ------      --------------------------              *
  284. *       1.3         09 Feb 89   first public release                    *
  285. *                                added GIF format output                *
  286. *       1.4         14 Feb 89   added TIFF Compression tag to satisfy   *
  287. *                                Optiks 2.11 (why, I don't know!)       *
  288. *                               and reversed video on GIFs              *
  289. *       1.5         27 Feb 89   tweaked TIFF output (ordered tags)      *
  290. *       1.6         20 Aug 89   added PCX output and made DPI=72        *
  291. *       1.7         18 Mar 90   fixed odd-sized PCXs                    *
  292. *************************************************************************
  293.  
  294.          ----------------end-of-author's-documentation---------------
  295.  
  296.                         Software Library Information:
  297.  
  298.                    This disk copy provided as a service of
  299.  
  300.                         The Public (Software) Library
  301.  
  302.          We are not the authors of this program, nor are we associated
  303.          with the author in any way other than as a distributor of the
  304.          program in accordance with the author's terms of distribution.
  305.  
  306.          Please direct shareware payments and specific questions about
  307.          this program to the author of the program, whose name appears
  308.          elsewhere in  this documentation. If you have trouble getting
  309.          in touch with the author,  we will do whatever we can to help
  310.          you with your questions. All programs have been tested and do
  311.          run.  To report problems,  please use the form that is in the
  312.          file PROBLEM.DOC on many of our disks or in other written for-
  313.          mat with screen printouts, if possible.  The P(s)L cannot de-
  314.          bug programs over the telephone.
  315.  
  316.          Disks in the P(s)L are updated monthly, so if you did not get
  317.          this disk  directly from the P(s)L,  you should be aware that
  318.          the files in this set may no  longer be the current versions.
  319.  
  320.          For a copy of the latest monthly software library newsletter
  321.          and a list of the 2,000+ disks in the library, call or write
  322.  
  323.                         The Public (Software) Library
  324.                               P.O.Box 35705
  325.                            Houston, TX 77235-5705
  326.                                (713) 524-6394
  327.  
  328.